package com.free.fs.service;

import com.free.fs.model.DocPojo;

import javax.servlet.http.HttpServletResponse;
import java.util.List;

/**
 * 公共文档服务接口
 *
 * @author dinghao
 * @date 2024/01/01
 */
public interface PublicDocService {

    /**
     * 获取文档列表
     *
     * @param path 目录路径
     * @return
     */
    List<DocPojo> getDocList(String path);

    /**
     * 根据文档ID下载文档
     *
     * @param docId 文档ID
     * @param fileName 自定义文件名（可选）
     * @param response
     */
    void downloadDoc(Long docId, String fileName, HttpServletResponse response);

    /**
     * 根据文档路径下载文档
     *
     * @param docPath 文档路径
     * @param fileName 自定义文件名（可选）
     * @param response
     */
    void downloadDocByPath(String docPath, String fileName, HttpServletResponse response);

    /**
     * 获取文档分类列表
     *
     * @return
     */
    List<DocPojo> getDocCategories();
}